PlotIcon

PlotIcon
Header:	Icons.h		Carbon status:	Supported

Draws an icon of resource type 'ICON' to which you have a handle.

void PlotIcon (
    const Rect *theRect, 
    Handle theIcon
);

theRect: A pointer to the rectangle in which to draw the icon, specified in local coordinates of the current graphics port.
theIcon: A handle to the icon to draw. You must have previously obtained this handle using the GetIcon function, or GetResource or other Resource Manager functions.

DISCUSSION

This function does not allow you to specify any transforms or alignment. The PlotIcon function uses the QuickDraw function CopyBits with the srcCopy transfer mode. To plot an icon of resource type 'ICON' with a specified transform and alignment, use the PlotIconHandle function.

If the destination rectangle is not 32 by 32 pixels, the function stretches or shrinks the icon to fit.

SPECIAL CONSIDERATIONS

This function may move or purge memory blocks in the application heap. For that reason, your application should not call it at interrupt time.

VERSION NOTES

This function is available in both System 6 and System 7.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.